$TXT Created by TOPPENBERG,KEVIN at FAMILY PHYSICANS OF GREENEVILLE (KIDS) on Wednesday, 08/20/08 
=============================================================================
Run Date: AUG 08,2008                   Designation: TMG-GUI-CONFIG*1.0*1
Package : TMG - FAMILY PHYSICANS OF GREENEVILLE  Priority: Optional
Version : 1       SEQ #1                       Status: Released
=============================================================================

Associated patches: None

Subject: Patch to support WorldVistA Configuration Utility

Category: 
  - Routine

Description: 
============

  This patch provides server support for a new Windows application that assists
  installers of new WorldVistA systems to configure aspects of the sytems.   

  SECURITY ISSUES:
  The configuration utility allows users easy access to all files on the system.
  Generally Fileman DB API calls are used for posting to the database.  One exception
  is made that allows users to set their Fileman access code to @.  Thus a user
  of this application can gain complete control of the sytem.  That was the intent,
  to allow administrators to effectively manage their systems.  But with easy use
  come easy potential for mistakes.

  Methods to limit access to the server:  During start up of the application, a 
  standard RPC login into the server is required.  The user must have the XUPROGMODE
  security key, OR have a unlocking menu OPTION added to their secondary menu field
  in their NEW PERSON file record.  The needed menu OPTION is:

      TMG RPC CONTEXT GUI_CONFIG  
  
  
  ROUTINE SUMMARY:
  ================
  Routine Summary
  The following routines are included in this patch.  The second line of each
  of these routines now looks like:
           ;;1.0;TMG-LIB;**[Patch List]**;07/20/08

                   Checksum
  Routine         Old       New      Patch List
  TMGRPC3           n/a  109709728   **1**

  Sites should use CHECK^XTSUMBLD to verify checksums.

  
  INSTALLATION INSTRUCTIONS:
  ==========================
  This patch should cause minimal impact on live systems, as it provides only 1 routine,
  1 OPTION, and 1 REMOTE PROCEDURE.  Installation will take less than 1 minute.  Users
  may remain on the system.  Note: the follow instructions were copied from another KIDS
  install and modified.  There may be some discrepancies.

  The following are instructions for those using the Packman method:
  ------------------------------------------------------------------  
  1.  Use the INSTALL/CHECK MESSAGE option on the PackMan menu.
   
  2.  Review your mapped set.  If any of the routines listed in the
      ROUTINE SUMMARY section are mapped, they should be removed
      from the mapped set at this time.
   
  3.  From the Kernel Installation and Distribution System Menu, select
      the Installation menu.
   
  4.  From this menu, you may elect to use the following options
      (when prompted for INSTALL NAME, enter TMG-GUI-CONFIG*1.0*1):
          a.  Backup a Transport Global
          b.  Compare Transport Global to Current System
          c.  Verify Checksums in Transport Global
   
  5.  Use the Install Package(s) option and select the package TMG-GUI-CONFIG*1.0*1.
   
  6.  When prompted 'Want KIDS to INHIBIT LOGONs during the install? YES//'
      respond NO.
    
  7.  When prompted 'Want to DISABLE Scheduled Options, Menu Options, and
      Protocols? YES//', respond NO.
   
  8.  If routines were unmapped as part of step 2, they should be returned
      to the mapped set once the installation has run to completion.

  9.  (See step 9 below)

  The following are instructions for those loading the patch via Host File System:
  ---------------------------------------------------------------------------------
  1.  Navigate the menu option path to reach the Kernel Installation and Distribution
      System Menu.  Or, the menu option XPD MAIN may be entered directly.

  2.  Next, at the menu displaying:
          Edits and Distribution ...
          Utilities ...
          Installation ...     <---------- pick this one.

  3.  Next, at the menu displaying the options as below, choose each of the options
      in a step-by-step fashion, in numerical order (i.e. 1, 2, 3 etc.)  Step #1 will
      prompt the user to enter the file path on the host file system where the source
      file is stored.  The filename to enter is TMG_GUI_CONFIG-1-1.kid, but add the
      appropriate path.  E.g. /tmp/TMG_GUI_CONFIG-1-1.kid

       1      Load a Distribution
       2      Verify Checksums in Transport Global
       3      Print Transport Global
       4      Compare Transport Global to Current System
       5      Backup a Transport Global
       6      Install Package(s)
              Restart Install of Package(s)
              Unload a Distribution

  4.  From this menu, you may elect to use the following options
      (when prompted for INSTALL NAME, enter TMG-GUI-CONFIG*1.0*1):
          a.  Backup a Transport Global
          b.  Compare Transport Global to Current System
          c.  Verify Checksums in Transport Global
   
  5.  Use the Install Package(s) option and select the package TMG-GUI-CONFIG*1.0*1.
   
  6.  When prompted 'Want KIDS to INHIBIT LOGONs during the install? YES//'
      respond NO.
    
  7.  When prompted 'Want to DISABLE Scheduled Options, Menu Options, and
      Protocols? YES//', respond NO.
   
  8.  If routines were unmapped as part of step 2, they should be returned
      to the mapped set once the installation has run to completion.

  9.  The user that will use the GUI must now have a menu option added as a 
      secondary menu.  Following is a screen log of adding this:

       
       GTM>do P^DI

       VA FileMan 22.0

       Select OPTION: entER OR EDIT FILE ENTRIES

       INPUT TO WHAT FILE: NEW PERSON//   <PRESS ENTER, or enter NEW PERSON if not shown>
       EDIT WHICH FIELD: ALL// secondARY MENU OPTIONS    (multiple)
          EDIT WHICH SECONDARY MENU OPTIONS SUB-FIELD: ALL//
       THEN EDIT FIELD:

       Select NEW PERSON NAME: Test  ZZ TEST,USER
       Select SECONDARY MENU OPTIONS: OR CPRS GUI CHART// TMG RPC CONTEXT GUI_CONFIG
         Are you adding 'TMG RPC CONTEXT GUI_CONFIG' as
           a new SECONDARY MENU OPTIONS (the 2ND for this NEW PERSON)? No// y  (Yes)
         SYNONYM:
       Select SECONDARY MENU OPTIONS:  <PRESS ENTER>
             
       Select NEW PERSON NAME:  <PRESS ENTER>

       Select OPTION:  <PRESS ENTER>
       GTM>


Routine Information:
====================

Routine Name:
  - CHANNEL^TMGRPC3


Routine Checksum:

=============================================================================
User Information:                               
Entered By  : TOPPENBERG,KEVIN            Date Entered : AUG 20, 2008
Completed By: TOPPENBERG,KEVIN            Date Completed: AUG 20, 2008
Released By : TOPPENBERG,KEVIN            Date Released : AUG 20, 2008
=============================================================================

Packman Mail Message:
=====================

$END TXT
